home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 1.iso / DEMON / ACORN-STARTER / STARTERF.TXT < prev    next >
Text File  |  1995-05-29  |  38KB  |  895 lines
  1.         ***************************************************************
  2.         * An Internet Starter Pack - For ACORN RISC OS 3.1+ Computers *
  3.         ***************************************************************
  4.  
  5.  
  6. FAQ & Starter Pack Version 1.2 1st June 1995
  7. ---------------------------------------------
  8.  
  9. *** Read this through once before doing anything else ***
  10.  
  11. Legalities & Disclaimer
  12. -----------------------
  13. Copyright 1994, 1995 Dr Alan Hassey. (alan@midwife.demon.co.uk)
  14. This document is freely distributable in unmodified form. No charge
  15. may be made for the use of The Starter-Pack or any part of it without
  16. the specific consent of the authors.
  17.  
  18. The author takes no responsibility for the accuracy of information 
  19. contained in this document. It is provided without express or implied 
  20. warranty or guarantee and its contents may be changed without notice.
  21.  
  22. If you have any comments or suggestions for improvements or 
  23. alterations, then please contact me at alan@midwife.demon.co.uk.
  24.                                        ~~~~~~~~~~~~~~~~~~~~~~~~
  25.  
  26. In general, queries or comments about individual applications should be 
  27. addressed to the respective s/w authors (see section D). All the 
  28. authors' copyrights and conditions of use must be preserved unless you
  29. have their specific permission to do otherwise.
  30.  
  31. Users of older RISC OS 3 machines should check whether they need the
  32. serial patch modules located in the Starter-Pack SerialApps directory.
  33. You will not need them if you have RISC OS 3.11 or above.
  34. You may also need a patched serial cable if you've got an A310, 440, 
  35. 4x0/1, A3000, A540, R140, or R260 Acorn machine. The wiring for an "Arc"
  36. type modem-lead are given in the file SerialComm.
  37.  
  38. The details of the serial port configuration is posted regularly as the:
  39.  
  40. Comp.Sys.Acorn FAQ List Posting (1/2) Section 2.6.
  41.  
  42. The serial modules can be found in the Starter-Pack:
  43.  
  44. (ref SerModules = StarterPak.SerialApps.SerModules)
  45.  
  46. If you are in doubt about the modules, then read the ReadMe file:
  47.  
  48. (ref ReadMe = StarterPak.SerialApps.SerModules.ReadMe)
  49.  
  50. The "Arc" wiring for a modem-lead can be found in:
  51.  
  52. (ref SerialConn = StarterPak.SerialApps.SerialConn)
  53.  
  54. Helpful Hints > modem-leads, PC vs Arc
  55. ---------------------------------------
  56. If you have a copy of ArcTerm7 there is an easy test you can apply to
  57. check which type of modem-cable you have. In ArcTerm7, select the driver
  58. as internal_pc (or sp_dualpc). Now check the status line near the bottom 
  59. right of the screen. If ArcTerm7 thinks the modem is permanently online 
  60. (even with the modem switched off), then it's an Acorn cable, so use the 
  61. internal (or sp_dual) serial driver. (Courtesy of Hugo Fiennes)
  62.  
  63. For users of !Hearsay there is also a quick test to check-out your modem
  64. lead. use the Terminal setup->Misc sub menu and open the command
  65. line editor. You enter the line:  {tprinti(devdcdbit)} 
  66. followed by <return>. If this prints 0 on the terminal you have an old 
  67. style (Arc) modem lead, if it prints 1, then you have a PC lead.
  68. This will only work if Hearsay is *not* set up for block operation.
  69. NB. !Hearsay does NOT need the block-drivers. (Courtesy of David Pilling)
  70. ---
  71.  
  72. Contents
  73. ========
  74.  
  75. A. Introduction
  76. B. Starter-Pack contents
  77. C. Connecting to the Internet
  78. D. Acknowledgments
  79.  
  80.                             --------------------
  81.  
  82. A. This Guide / FAQ / Manual
  83. ============================
  84.  
  85. Introduction
  86. ------------
  87. This Guide is a short (and friendly) introduction to The Internet for 
  88. Acorn RISC OS 3.1+ computer users. The Guide is written primarily for 
  89. those connecting to the Internet via Demon. Most Acorn users seem to 
  90. have a found a home of sorts at Demon and most of the help, advice 
  91. and software you will need is there. (Though not from Demon Support!). 
  92. It should be fairly simple to change the configuration setup to suit 
  93. other service providers. Most of these changes will be to the !Slipdial
  94. scripts. 
  95.  
  96. The main aim of the guide is to get you up and running with your
  97. Acorn computer in the minimum possible time and with the minimum fuss.
  98.  
  99. The guide is not comprehensive and will not tell you everything you 
  100. always wanted to know about the net... but it will tell you enough to 
  101. configure your computer and a basic set of software. The Internet
  102. Starter-Pack will provide you with software to perform the following
  103. functions:
  104.  
  105.     Dialup connection to Demon Internet
  106.     News/Email facilities
  107.     Telnet/ftp facilities
  108.  
  109. The Starter-Pack does not provide a browser or other s/ware for access
  110. to the World-Wide-Web, though this s/ware is available for download from
  111. Demon's ftp site.
  112.  
  113. You will not need any special technical skills to follow the guide or
  114. configure your system. If I can manage it, then so can you!
  115.  
  116. Read the Guide right through once before you start unpacking anything!
  117.  
  118. The Starter-Pack software & guide will only be posted to Demon & 
  119. Arcade BB initially, but feel free to pass it on anywhere else you 
  120. think it might be useful. Only use the latest version of The Starter
  121. Pack. You must also ensure that the version of this Guide matches the
  122. Starter-Pack version!
  123.  
  124. (ref ftp.demon.co.uk - in directory /pub/archimedes/acorn-starter-pak)
  125.                        (files are StarterTXT, sparkplug & StarterPak)
  126. (ref ARCADE BBS = 0181 654 2212)
  127.  
  128. Once you are connected, most of the software you need is available 
  129. via the Demon Internet FTP (File Transfer Protocol) site:
  130.  
  131. ftp.demon.co.uk - in directory /pub/archimedes.
  132.  
  133. Unfortunately, Demon Support seem to know almost nothing about 
  134. Acorn computers, though there are now signs of this changing! 
  135. (Dave Williams - Dave@demon.net is trying to educate Demon about
  136. Acorn RISC OS computers!)
  137.  
  138. The best place to get help and advice is probably via the newsgroups 
  139. (see below). 
  140. The group: demon.ip.support.archimedes is particularly useful.
  141.  
  142.  
  143. B. Starter-Pack Contents
  144. ------------------------
  145.  
  146. This guide should be enough to get you started. For more detailed help 
  147. and advice, I have included several other documemts in the FAQs directory
  148.  
  149. (ref FAQs = StarterPak.Docs.FAQs)
  150.  
  151. These are:
  152.  
  153. 1. Demon <Dir>   - Demon Internet files (see files 1a - h below).
  154.  1a ModemTxt     - Demon's "ModemTxT" FAQ - Modem setup textfile.
  155.  1b Welcome      - Demon's "Welcome" FAQ.
  156.  1c VirtPoPs     - Demon's virtual PoPs phone list.
  157.  1d Services     - Demon services
  158.  1e ServersUPd   - Up to date list of Demon gateways.
  159.  1f WWW_TxT      - Demon's introduction to the World Wide Web.
  160.  1g BatchFTP     - Demon's batch FTP service - FAQ.
  161.  1h RoadMap      - Pointer to resources for new users.
  162. 2. Acorn FAQ     - Kevin Quinn's FAQ - Using Acorns for Internet access.
  163. 3. Guide1_21     - Paul Allen & The ARM Club's KA9Q guide (to TCPIP v1.21).
  164. 4. Zynet <Dir>   - Zynet FAQ.
  165.  4a ZynetFAQ     - Information about Zynet.
  166. 5. ScriptHelp    - How to edit/write !Slipdial scripts.
  167. 6. Useful?       - Miscellaneous hints & tips.
  168. 7. Freenet <Dir> - This module & its associated programs are going to
  169.                    revolutionise access to the Internet for RISC OS users!
  170.  7a. 1           - !Freenet announcement 1.
  171.  7b  2           - !Freenet announcement 2.
  172.  7c  3           - Program description.
  173.  7d  FreeNSetUp  - How to set up !Freenet applications.
  174.  7e  FreeNSite   - !Freenet ftp site.
  175.  
  176. !Freenet has only just been released and these documents are a brief introduction to !Freenet, what it does & where to find it.         
  177.  
  178. The software described below may not be the "best" or most elegant
  179. way of accessing Demon Internet, but it all works and is fairly simple 
  180. to configure. New software for accessing the Internet apears nearly 
  181. every month. I will make no attempt to keep the Starter-Pack up-to-date 
  182. with every version change etc, but will review it with major version 
  183. changes and when important new software is released, stable and 
  184. documented. 
  185.  
  186. To get started, you will need:
  187.  
  188. !SparkPlug
  189. !DemConfig   >>>  - Will configure all the rest & create !NewsDir
  190. !TCPIP
  191. !TCPIPUser
  192. !TTFN
  193. !NewsBase
  194. !Slipdial
  195. !SerialApps  >>>  - Contains !SerialDev (serial device drivers)
  196. Utilities         - Contains !UUcoder & newgroups                  
  197.  
  198. !Sparkplug is a great little program for unpacking files. It is 
  199. supplied as a self-extracting basic program in the starter-pack. 
  200. Make sure that the  file-type option is set to Basic, then double-
  201. click over the basic program Sparkplug. It will unpack itself and 
  202. place itself in your root directory. 
  203.  
  204. Double-click on the !SparkPlug icon to load it onto the icon-bar. To 
  205. unpack everything else, drop their icons onto !SparkPlug on the icon-
  206. bar. You will use this program time and again to unpack archives from 
  207. the Internet. The latest version can be found by ftp'ing to demon in:
  208. /pub/archimedes/utils. 
  209.  
  210. Let's Go !!!
  211. ------------
  212. Before you start, you should know:
  213.  
  214. 1. Your nodename (mine is midwife)
  215. 2. Your IP address (mine is 158.152.38.98)
  216. 3. Your password (keep it a secret!)
  217.  
  218. NB. You MUST have this information for the rest of the setup to succeed.
  219. !DemConfig can try to get it for you, but several users have reported
  220. difficulties with this part of the Starter-Pack and it's only fair to
  221. warn you about this. Demon Support should be able to give you this initial 
  222. information if you have problems.
  223.  
  224. Create a directory to store all your Internet applications in;
  225. eg. ADFS::IDEdisc4.$.Internet
  226.     SCSI::HardDisc5.$.Comms
  227.  
  228. Unpack (use !Sparkplug for this) the programs into your 
  229. Internet directory.
  230.  
  231. When you have finished, your directory structure should look like this:
  232.  
  233. ADFS::IDEDisc4.$.Internet (directory)
  234.  
  235. !DemConfig            Application
  236. !NewsBase                "
  237. !TTFN                    "
  238. !NewsDir              This will be created by !DemConfig  
  239. !TCPIP                   "
  240. !TCPIPUser               "   
  241. !Slipdial                "
  242. SerialApps             <dir>
  243. !SerialDev            Unpack this application from the SerialApps <dir>
  244. Utilities              <dir> 
  245. Docs                  The Guide & FAQs <dir>
  246.  
  247. !SerialDev & !Sparkplug may reside in this directory if you wish, as may
  248. any other files or directories. When you have connected to the Internet
  249. you may wish to add other applications (eg !ChangeFSI !Freenet & the 
  250. various WWW (World-Wide-Web fetchers) so this directory could become 
  251. quite large very quickly.
  252.  
  253. 1. !DemConfig
  254. --------------
  255.  
  256. If you have never logged on to Demon, and you don't have a password or 
  257. IP address, !DemConfig can now carry out an initial logon for you.
  258. A new option "Call Demon now to get IP address" has been added.
  259. If you select this option, then when you click on the Configure button,
  260. !DemConfig starts up !SLIPdial with a special script which dials Demon
  261. to perform the initial login.  The purpose is to set a password
  262. and to get your IP address, which is needed by !TCPIP.  Note that
  263. !DemConfig closes down while this login is being done; it is restarted
  264. when the SLIPdial script completes.  The script can cope if the password
  265. has already been set (as long as you don't change it).
  266.  
  267. !DemConfig no longer deletes the !NewsDir directory when run, so 
  268. !DemConfig can now safely be used many times without losing mail or news.
  269.  
  270. Whenever you click on the <Configure> button, !DemConfig saves the
  271. choices made so far.  So if you make a slight modification, you don't
  272. have to enter everything again from scratch.
  273.  
  274. As software upgrades become available - update each application 
  275. separately & do not use !DemConfig unless you want to start again.
  276.  
  277. !DemConfig will make initial configuration of your Internet software 
  278. very easy! Double-click over the application icon to run !DemConfig 
  279. and the dialogue window will open. Fill in the dialogue boxes as 
  280. shown below.
  281. NB. !DemConfig supports the Acorn !Help application, so
  282. interactive help is available for you as you start the program.
  283.  
  284. !DemConfig will then configure your Starter-Pack software for you. 
  285.  
  286. !DemConfig - dialogue window;
  287.  
  288. Modem & Serial Interface:
  289. Modem type:      Select from list (if you choose "other" the driver just
  290.                  sends the "ATZ" string.
  291. Serial port:     Internal for standard ACORN machine or SP_Dual if you
  292.                  have "The Serial Port's" dual card fitted. If a commerc-
  293.                  -ially obtained PC-wired modem lead is being used, then
  294.                  the block driver name must be specified as SP_DualPC.
  295.                  An "ARC" wired lead must be used with SP_Dual.
  296. Cable type:      Acorn or PC
  297. Serial speed:    This is the serial port speed (not the modem speed). It 
  298.                  will always work if you set it to "0", though you are
  299.                  unlikely to get the best possible performance. Try
  300.                  increasing it in multiples of 19200 - so an A5000 or
  301.                  RISC PC will typically be able to run at 57600.
  302. Phone details
  303. Mercury Button:  Press to select/deselect Mercury dialler info to be 
  304.                  added to demonconfg file in !Slipdial.
  305. Mercury PIN:     132 or 131,xxxxxxxxxx <<< the comma is vital !!!
  306. Use Mercury for 
  307. all PoPs:        Toggle on/off by selecting/de-selecting.
  308. Nearest PoP:     Select your nearest vPoP from the menu button.
  309. 2nd choice PoP:  As above.
  310. 3rd Choice PoP:  As above.
  311. Demon Account:
  312. Node name:       Your nodename (mine is midwife)
  313. Password:        Enter your new password (keep this secret)
  314.                  Passwords should be 6 characters minimum & MUST include
  315.                  at least one letter and number (eg abc1xyz)
  316. IP address;      158.152.38.98 (this is mine)
  317.  
  318. *** Select the "Call Demon now to get IP address" button if you need 
  319. to set a password & collect your IP address, otherwise turn it off ***
  320.                                              
  321.  
  322. User details:
  323. Userid:          "jbloggs" - or whatever you call yourself! - I'm "alan".
  324. Name:            Full name - I'm Alan Hassey!
  325. Organisation:    Optional - I'm at "The Hacienda" (geddit?).
  326.  
  327. Then press the <Configure> button.
  328.  
  329. The !NewsDir application will be created during configuration and added
  330. to your Internet directory.
  331.  
  332. You will be informed when the configuration process is complete.
  333.  
  334. Most of the work is now done :-)
  335.  
  336. If you want more information on the !DemConfig application look at the 
  337. !DemConfig Help file:
  338.  
  339. (ref !Help = !DemConfig.!Help)
  340.  
  341. 2. !TCPIP (KA9Q) & !TCPIPUser
  342. -----------------------------
  343.  
  344. TCP = Transmission Control Protocol, IP = Internet Protocol = TCPIP
  345.  
  346. TCPIP is your interface with the Internet. It receives and sends messages 
  347. to and from the Internet and RISC OS applications. Confusingly, TCPIP is 
  348. also known as KA9Q. TCPIP (KA9Q) must be carefully configured before you 
  349. can use it. The programs share information - so be wary of making changes 
  350. anywhere! If you want to experiment, then keep a COMPLETE backup of your 
  351. Internet directory somewhere safe...you have been warned! 
  352.  
  353. !DemConfig will configure !TCPIP & !TCPIPUser for you. You do not need to
  354. do anything else. However, if you want to alter your !TCPIP configuration
  355. then change the data in the !Setup file and run !Config. 
  356.  
  357. (ref !Setup = !TCPIPUser.TCPIP_New.!Setup)
  358. (ref !Config = !TCPIPUser.TCPIP_New.!Config) 
  359.  
  360. !TCPIP is a complicated program to get to know. It may well be worth your
  361. while loading and running !TCPIP by itself so you can explore & experiment
  362. a bit without damaging your phone bill. 
  363.  
  364. TCPIP Hints: I strongly suggest you look at the macros menus available
  365. from the TCPIP main window (to the R of the top dialogue box).
  366.       
  367. When using ftp (file transfer protocol) I suggest you set the "path"
  368. option to "auto". This will ensure that you download files with the
  369. correct filetype. You need to do this at the beginning of each ftp
  370. session.
  371.       
  372. (This can also be done via the ftpopt command in the !TCPIPUser.Config 
  373. file, or by creating a command file called via the aftp command). 
  374.  
  375. NB. Remember the RISC OS 10 character filename limit!!!
  376. ~~~ Most ftp sites are Unix-based & allow long-filenames.
  377.  
  378. If you forget & "get" 2 imaginary files from an ftp site, eg:
  379.  
  380. 1. get arcNetprog_0.45.spk (Unix long filename)
  381. 2. get arcNetprog_0.45.txt
  382.  
  383. They will both be downloaded with the name "arcNetprog" (10 chars)
  384. & the 2nd file will over-write the first, so you lose it! 
  385. Use the "get" command like this:
  386.  
  387. 1. get arcNetprog_0.45.spk aNet045spk 
  388. 2. get arcNetprog_0.45.txt aNet045txt
  389.  
  390. This version of the "get" command gets the files & renames them:
  391.  
  392. get <long_filename> & rename as <short_filename> 
  393. So you will end up with the 2 files aNet045spk & aNet045txt in your 
  394. Downloads directory.
  395.  
  396. If you set the path to "auto" from the macros menu, then TCPIP will
  397. attempt to download the file into a directory of the appropriate filetype.
  398. So you will receive the above xxx.spk file into <dir>:downloads.archives
  399.                             & xxx.txt file into <dir>:downloads.Docs
  400.  
  401. The "get" command is supplemented by "mget" (multiple get) which can be
  402. used to get several files. The format for the command is:
  403.  
  404. mget <filename1> <filename2> <filename3> etc which means
  405. get filename1 & get filename2 & get filename3 etc.
  406. Filenames should be separated by spaces.
  407.  
  408. NB. If you use "mget", make sure you set the "path auto" option first
  409. because the <long_filename> <short_filename> option has been replaced by
  410. mget <filelist.....>
  411.  
  412. aftp
  413. ====
  414. I have included some ftp "accounts", these are for:
  415.  
  416. 1) Demon ftp
  417. 2) Graham Allen's mnhep ftp site (for !NewsBase upgrades)
  418. 3) The !Freenet site at Southampton
  419. To access these type:
  420.    aftp demon <return> for demon
  421.    aftp mnhep <return> for the !NewsBase site
  422.    aftp cslib <return> for the !Freenet site
  423.  
  424. I'm not going into great detail about the aftp command but it is so useful
  425. it deserves this special mention. 
  426.  
  427. The aftp command for either logs you into the appropriate ftp site and sets
  428. various parameters as follows:
  429.         prompt short
  430.         trace 0
  431.         path auto
  432.         i
  433.         hash 1
  434.  
  435. This aftp setup is fairly safe & will not do anything silly. The setup
  436. parameters passed in this file set path auto, binary filetype (i) and
  437. hash 1. 
  438.  
  439. For more detail - see the help files etc written by Adam Goodfellow and 
  440. enclosed in the Starter-Pack !TCPIP application within the TCPIP_Doc
  441. directory.
  442.  
  443. (ref !ReadMe = !TCPIP.TCPIP_Doc.Notes & TCPIP_Doc.History)
  444.  
  445. More Macro Menus!
  446. I have included some extra macros menus for you to try, supplied by other 
  447. users. These offer some extra services via the macros menu. There are 2 
  448. alternative "ftp" menus and a "Talkers" menu. The "Talkers" menu should
  449. replace the "Main" menu in: !TCPIPUser.Menus - after you have UUdecoded it!
  450. (Use !UUcoder for this).
  451.  
  452. (ref alternative menus = !TCPIPUser.Menus.AltMenus)
  453.  
  454. Each of the AltMenus includes directions and advice.
  455.  
  456. I have also enclosed the old ArcKA9Q manual which is rather out of date 
  457. but gives some useful tips on TCPIP commands. This has been renamed 
  458. Guide1_21 and can be found in the FAQs directory.
  459.  
  460. (ref Guide1_21 = StarterPak.Docs.FAQs.Guide1_21)
  461.  
  462. I suggest you do not make any changes to your configuration files based 
  463. on this old document until you know what you are doing!
  464.  
  465. Trying to get to grips with !TCPIP is the most difficult part of this
  466. whole process. Don't waste too much time on it - you can connect, send
  467. & receive mail/news, logout, read  & reply to your mail/news & never issue
  468. a !TCPIP command directly! You will need some basic commands to do telnet
  469. or ftp sessions. Even so - don't get bogged down in !TCPIP - it's about to
  470. be replaced by !Freenet which has a whole new set of commands to worry
  471. about :-)
  472.  
  473. 3. !NewsBase
  474. -------------
  475. !NewsBase works with TTFN to process news and mail. The NewsBase program
  476. basically splits the downloaded news file into separate messages. 
  477. The news file is often referred to as a "news batch", and the process 
  478. of splitting it up is often referred to as "debatching".
  479.  
  480. !NewsBase now supports the Acorn interactive help program and !StrongHelp.
  481. There is no longer a "Docs" directory within !NewsBase, so use the inter-
  482. active help - it's very good.
  483.  
  484. Double-click on !NewsBase to load it onto the icon bar. The first thing
  485. !NewsBase will try to do is look for the !NewsDir application. If it 
  486. does not exist, then !NewsBase will create !NewsDir in your Internet
  487. directory.
  488.  
  489. If you change your setup, or accidentally delete !NewsDir, then you will 
  490. be warned, that !NewsBase cannot find !NewsDir. A News Directory box will 
  491. appear, drag the icon to your Internet directory, where your new !NewsDir 
  492. will appear. 
  493.  
  494. NB. Remember to keep all your applications in the same directory.
  495. (Or at least on the same disk!)
  496.  
  497. !NewsBase will then start and will attempt to configure itself from the 
  498. data you supplied to !DemConfig. When NewsBase has finished, you will 
  499. be notified of the arrival of four new articles & mail for postmaster. 
  500. Click on the <Read> button to install !TTFN on the icon-bar. 
  501. !TTFN is your news & mail reader program (see below).
  502.  
  503. !NewsBase has more detailed setup options and you can look at these by 
  504. clicking <menu> over the !NewsBase icon & selecting <setup>, or by 
  505. clicking with <adjust>. The NewsBase Control Panel will appear, with 6 
  506. options for configuring or reconfiguring !NewsBase, these are:
  507.  
  508. 1. Site
  509. 2. General
  510. 3. Transports
  511. 4. Groups
  512. 5. Configure Users
  513. 6. Filters
  514.  
  515. 1. Site - should need no further attention. 
  516. 2. General - no need for further entries now.
  517. 3. Transports - should read ka9q. Leave this alone unless you know about
  518.    Taylor, soup & uucp.
  519. 4. Groups - a suggested group list is given below and I recommend that 
  520.    you read the !NewsBase documentation carefully here.
  521. 5. Users - change the Username to your name from the options list
  522.    and press <Save>.
  523. 6. Filters - I suggest you leave this option alone until you have read 
  524.    the !NewsBase documentation carefully. No need for further entries now.
  525.  
  526.  
  527. !NewsBase holds information on newsgroups of 2 types :-
  528. 1. Those in the "Newsfeed"
  529. 2. Those in the "Database", ie. those with files in !NewsDir.
  530.  
  531. To add more newsgroups, select the "Newsfeed" option & enter the name of the
  532. group(s) you wish to receive. Wildcards are valid, so entering:
  533.  
  534. comp.sys.acorn* will ensure you get all the groups under this hierarchy.
  535. Groups in the newsfeed will usually join the database list as traffic flows
  536. in that newsgroup. (This replaces the old concept of "active" & "current"
  537. newsgroups in !NewsBase versions up to 0.54i)
  538.  
  539. I have listed below a few newsgroups you might want to subscribe to:
  540.  
  541. demon.ip.support.archimedes
  542. demon.announce
  543. demon.archives.announce
  544. demon.news
  545. comp.sys.acorn*             (This will give you all the acorn groups)
  546. news.announce.newusers
  547.  
  548. The groups:
  549.  
  550. comp.sys.acorn.announce
  551. comp.sys.acorn.networking
  552. demon.announce
  553. demon.ip.support.archimedes
  554.  
  555. are in the "Newsfeed" & should be fed to you anyway.
  556.  
  557. A full list of newsgroups available via Demon can be obtained by ftp to:
  558. ftp.demon.co.uk:/pub/news/active.zip (or active.Z).
  559.  
  560. !NewsBase can also work with the !Groups application. This is a very nice
  561. little program which makes editing the newsgroup database very easy.
  562. !Groups is included in the !NewsBase autoboot <dir> and is accessed via 
  563. the !NewsBase icon menu by selecting the "New Groups..." option.
  564. It can be configured to edit newsgroup details either from a database of 
  565. all newsgroups (eg active.zip above) or from your own defined feed. 
  566.  
  567. For !Groups to work it must be able to find the file: 
  568. !NewsDir.newsbase.newgroups.
  569.  
  570. This file will not be created until after your first connection to Demon.
  571. I have included a "dummy" newgroups file which you should move from the
  572. Utilities <Dir> to !NewsDir.newsbase, so you can access the !Groups program.
  573. To add groups to the newsfeed, drag them from the "New groups" window to the
  574. "Your news feed" window". To delete groups from the newsfeed, click <adjust>
  575. over the group to be deleted. You will be asked to confirm group changes.
  576.  
  577. If you have (or get) a copy of Active.zip, you can use !Groups to add all 
  578. the newsgroups you want by pressing mouse <menu> over the Newsgroups display window & <select>ing the "Configure..." option. Unzip the file & drag it
  579. to the configuration window and you will have a choice of thousands of 
  580. newsgroups.
  581.  
  582. The !Groups program contains full details of setup and operation. 
  583.  
  584. (ref !Groups = !NewsBase.Autoboot.!Groups)
  585. (ref newgroups = !Utilities.newgroups) move to (!NewsDir.newsbase)
  586. (ref Help = !NewsBase.Autoboot.!Groups.!Help)
  587.  
  588. This version of !NewsBase also includes access to the !Qedit program. 
  589. This allows you to view the mail/news queue and perform a variety of 
  590. operations on  it. To access !Qedit, press <menu> over the !NewsBase 
  591. icon on the icon-bar and choose the "Queues..." option. Menu and help 
  592. screen are available by clicking <menu> over the !Qedit window. A !Help
  593. file is also available within the program application directory.
  594.  
  595. (ref !Help = !TCPIPUser.AutoBoot.!Qedit.!Help)
  596.  
  597. !Qedit can also be accessed via the macros menu of !TCPIP.
  598.  
  599. 4.!NewsDir
  600. ----------
  601. This application stores your news & mail. It also stores some config-
  602. uration information for !NewsBase & some information about you. It is 
  603. worth having a look at your UserHome directory & setting up your 
  604. signature & userinfo details.
  605.  
  606. (ref = !NewsDir.UserHome.yourname <dir>)
  607.  
  608.  
  609. 5. !TTFN
  610. ---------
  611.  
  612. (TTFN = The Thread Following NewsReader)
  613.  
  614. This is the news & mail reader provided to work with NewsBase. This 
  615. should be installed on the icon-bar with your name underneath. If not, 
  616. double-click on its icon in the Starter-Pack to load !TTFN. 
  617.  
  618. You will have noticed a "New Newsgroup Created" box has appeared, 
  619. asking if you would like to subscribe to the newsgroup; 
  620. newsbase.announce.newusers. Click on <Yes>.
  621. The Newsgroups Status window for user "you" will now appear. Select the
  622. radio-button on the left to enable thread-following. This allows you to
  623. collect together news/mail with the same subject-line as a "thread".
  624. Double-click on the line newsbase.announce.newusers and the titles of 
  625. four articles will appear. These articles are actually regularly posted 
  626. FAQs which you should read.
  627.  
  628. Click menu over the !TTFN icon & change the user to "postmaster". 
  629. You will find some Email is waiting for "postmaster".
  630.  
  631. !TTFN's setup screens are accessed via <menu> or <adjust> from the icon-bar. 
  632. Setup is easy and the documentation provided is very good. You do not 
  633. need to make any changes to TTFN Setup unless you want to. Press <Save> 
  634. to store any changes permanently.
  635.  
  636. To subscribe a new user to the currently available newsgroups, click on
  637. the TTFN menu & select the "Users..." option. From here, select 
  638. "Create User". Give yourself an ID (mine is "alan"). Then click on the 
  639. "Group subscription" button to open the subscription list. 
  640. Click on the groups you wish to join. If you want to join a group which 
  641. is not listed, then create the group via the "Groups" option in !NewsBase.
  642. This option is not available until you have a list of groups created to
  643. choose from.
  644.  
  645. (ref !TTFN documentation = !TTFN.Docs.UserGuide)
  646.  
  647. Clicking <adjust> over the !TTFN icon, opens a scrollable Setup window. 
  648. Open the address book. This contains a few names and Email addresses 
  649. for you. You can edit this list as you wish.
  650.  
  651. 6. !Slipdial
  652. -------------
  653.  
  654. Slipdial is your dialler program. It will run a script (default is 
  655. Demon) which will connect you to the Demon PoPs of your choice, then 
  656. autoboot !TCPIP to connect you to Internet. When you disconnect from 
  657. Internet, the Demon script will load !TTFN & !NewsBase, commence 
  658. debatching news & mail and advise you when your news and mail is ready 
  659. to read. 
  660.  
  661. You need to make sure your modem is properly configured to run !Slipdial.
  662. Demon produce a good FAQ to help with modems & this is included in the
  663. FAQs directory:
  664.  
  665. (ref = ModemTxt = StarterPak.Docs.FAQs.Demon.ModemTxt)
  666.  
  667. This file gives full details on setting up your modem for connection
  668. to the Internet. 
  669.  
  670. NB. Most of the problems reported with !Slipdial are serial/cable
  671. problems (check your cable & your serial driver).
  672.  
  673. The information you supplied to !DemConfig will have created a file 
  674. called "demconfg" (previously called demonconfg in earlier versions of
  675. the Starter-Pack),  which you can view/edit in the scripts subdirectory. 
  676.  
  677. NB. Be careful of making ANY changes here.
  678.  
  679. (ref demconfg = !Slipdial.Scripts.demconfg)
  680.  
  681. To check or change the !Slipdial default script, click menu over the 
  682. !Slipdial icon & select choices. The default script will appear in the
  683. dialogue box in the format:
  684.  
  685. ADFS::IDEdisc4.$.!Slipdial.Scripts.demon
  686.  
  687. The Auto-run button should be ticked. You can choose to run other scripts
  688.  
  689. eg. .....Slipdial.myscript
  690.  
  691. or you can deselect the Auto-run facility. 
  692.  
  693. I have included several example scripts for you to play with. 
  694.  
  695. If you are interested in writing your own scripts, then see Alan Fitch's
  696. excellent ScriptHelp in the FAQs directory. 
  697. (I suggest you read it anyway!)
  698.  
  699. (ref ScriptHelp = StarterPak.Docs.FAQs.ScriptHelp)
  700.  
  701. The default "Demon" script now uses the new Demon Virtual PoPs (vPoPs).
  702. This script also gives you access to the new "local" facility for making 
  703. local call connections & by-passing your Mercury PIN. (Only relevant if 
  704. you have a Mercury account & a local vPoP). The mew "Demon" script allows
  705. much more control over dialling options and debugging. Full details are
  706. in ScriptHelp (see above).
  707.  
  708. The "Demon" script allows you to specify which modem-driver you want.
  709. I'm always on the lookout for new modem-scripts, so if you've got one that
  710. works - please send it to me & I'll include it in the Starter-Pack.
  711.  
  712. (ref drivers = !Slipdial.Drivers.ReadMe)
  713.  
  714. !Slipdial can be controlled from the program window. Click on the program
  715. icon to open the !Slipdial window. The "Select..." dialogue allows you
  716. to choose which script to run when the program is stopped, or which PoP
  717. to call when the script is paused. The other icons on the right control:
  718. redialling, pause (toggle) & stop.
  719.  
  720. !DemConfig will configure !Slipdial for Mercury or BT use. 
  721.  
  722.  
  723. 7. !SerialDev
  724. --------------
  725.  
  726. The serial device drivers are run under the !SerialDev application.
  727. !SerialDev be unpacked from the SerialApps <dir> and placed in your 
  728. internet or root directory:
  729.  
  730. eg ADFS::IDEDisc4.$.!SerialDev or 
  731.    ADFS::IDEDisc4.$.Internet.!SerialDev
  732.  
  733. (ref !SerialDev = SerialApps.!SerialDev)
  734.  
  735. The rest of the SerialApps directory can be placed in a separate 
  736. directory out of the way if you don't need it.
  737.  
  738. You should always use the latest version of the drivers which are 
  739. available from demon in; /pub/archimedes/blockdrivers.
  740. They are a resource used by other applications which need to be able 
  741. to "see" them - hence put them in your root directory, or if this is 
  742. too untidy for you - then in your comms or Internet directory.
  743.  
  744. NB. This version of the blockdrivers is compatible with !Freenet.
  745.  
  746. The serial port on your computer can cause problems, especially if 
  747. you have an early RISC OS 3 machine. Various patches and modules are 
  748. available to help remedy these problems - please refer to The AcornFAQ 
  749. in the documents directory sections 8a,b & the ReadMe file in the 
  750. SerModules sub-directory. These patch modules are included in the 
  751. SerialApps directory. You will need them if you run RISC OS 3.1 or 
  752. earlier. Versions 3.11+ should be OK. Also included is a wiring diagram 
  753. for an Arc modem lead connection (SerialConn).
  754.  
  755. (ref AcornFAQ = StarterPak.Docs.AcornFAQ)
  756. (ref SerModules = StarterPak.SerialApps.SerModules)
  757. (ref ReadMe     = StarterPak.SerialApps.SerModules.ReadMe)
  758. (ref SerialConn = StarterPak.SerialApps.SerialConn)
  759.  
  760.  
  761. 8. Utilities (!UUCoder & newgroups)
  762. -----------------------------------
  763.  
  764. !UUcoder is in the Utilities <dir>. It makes UUencoding & decoding
  765. very easy. (!TTFN can also UUdecode files for you). You will need it if 
  766. you want to send binary files via Email. Full instructions are included
  767. within the application. Try it out on the "Talkers" file mentioned earlier.
  768.  
  769. (ref Help = Utilities.!UUcoder.!Help)
  770.  
  771. The newgroups file should be moved into !MailDir.newsbase <Dir>.
  772. (See !Groups above)
  773.  
  774. That's it - you are now ready to go!!!         :-)
  775.  
  776.  
  777. C. Running the software & connecting to the Internet
  778. ====================================================
  779.  
  780. ************************
  781. *** Before you start ***
  782. ************************
  783.  
  784.  
  785. The commonest 2 reasons for failure to connect are:
  786.  
  787. 1. You did not read the documentation properly.
  788. 2. Wrong combination of serial-driver & modem-lead.
  789.  
  790. These 2 reasons account for >90% of the calls I get because
  791. "Your *%$!@~? Starter-Pack does not work........"
  792.  
  793. So, before you call me or any of the authors, please:
  794.  
  795. 1. RTFM :-)
  796. 2. Check your modem-lead & serial setup.
  797.  
  798.  
  799. So what next?
  800. -------------
  801.  
  802. I suggest you reboot your machine & then open your Internet directory. 
  803. Remember that the applications need to have "seen" the !SerialDev, 
  804. !Scrap & !System applications to work properly.
  805.  
  806. Double-click on !Slipdial, which will load onto the icon-bar & open its
  807. dialogue box. Wait a second or two for the appropriate script to load, 
  808. select your vPoP from the menu & double-click. Your modem will now
  809. dial-out & connect you to your chosen PoP. Or click over the "Local" 
  810. icon to direct-dial your local vPoP. 
  811. !Slipdial will display several messages as it connects & logs in. 
  812. When a full connection is established, it will boot !TCPIP & install it 
  813. on the icon-bar. Mail & news can now be sent/retrieved via the smtp & 
  814. nntp kick commands.
  815. (This can be automated via your !TCPIPUser.AutoExec file).
  816.  
  817. You will be notified of incoming mail and news, which you can read via
  818. !TTFN & !NewsBase.
  819.  
  820. A selection of commonly used commands are available directly from the 
  821. macros menu at the top right of the TCPIP main screen. At first, it may 
  822. well be worth changing to the long time-out option (also via the macro 
  823. menu) so that TCPIP does not hang up before you have had an opportunity 
  824. to find your way around.
  825.  
  826. When you have finished your session(s),log-out by typing "quit" & pressing 
  827. the RETURN key. !Slipdial will disconnect, stop !TCPIP & remove it from 
  828. the icon-bar. It will then load !TTFN & !NewsBase. Your news and mail will 
  829. be debatched for reading. 
  830.  
  831. If you decide to dial back into the Internet, !Slipdial will remove !TTFN
  832. & !NewsBase from the icon-bar as it runs the script-file again.
  833.  
  834. When quitting altogether, it is wiser to do a controlled shutdown via the
  835. ACORN icon (or CTRL+SHIFT+F12) than a reset (CTRL+BREAK or RESET button)
  836.  
  837. Have fun and please let me know how the ACORN RISC OS 3.1+ Internet 
  838. Starter-Pack could be improved :-)
  839.  
  840.  
  841. D. Acknowledgements
  842. -------------------
  843.  
  844. To all the authors who agreed to the inclusion of their programs,
  845. FAQs & other documents in the Starter-Pack;
  846.  
  847. *  Robert Orwin for !TTFN.
  848. *  Graham Allen for !Slipdial
  849. *  Graham Allen, Thomas Aeby & Gunnar Zotl for !NewsBase.
  850. *  Adam Goodfellow, Anthony Frost & Jonathan Naylor for !TCPIP.
  851. *  David Pilling for !SparkPlug & SerialBuff.
  852. *  Hugo Fiennes for !SerialDev.
  853. *  Colin Hogben for !DemConfig.
  854. *  David Croft for !Qedit & !Groups.
  855. *  John Allen for !UUcoder.
  856. *  David Dade & ACORN Ltd for the serial modules.
  857. *  Paul Allen & The ARM Club for the KA9Q guide1_21.
  858. *  Alan Fitch for  !ScriptHelp & the "Demon" !Slipdial script.
  859. *  Demon Internet Ltd for the Demon documents. 
  860. *  Kevin Quinn for the Acorn FAQ.
  861. *  Merlyn Kline for the Zynet FAQ.
  862.  
  863. To everybody else who contributed and to you for using it.
  864.  
  865. Comments & queries about specific software should be addressed to the
  866. authors as follows;
  867.  
  868. ¤  !TTFN                     ttfn@wong.demon.co.uk
  869. ¤  !NewsBase  & !Slipdial    allan@mnhep1.hep.umn.edu
  870. ¤  !Slipdial scripts         alan@cycle.demon.co.uk
  871. ¤  !TCPIP & !TCPIPUser       tcpip2@comptech.demon.co.uk
  872. ¤  !SerialDev                altman@cryton.demon.co.uk
  873. ¤  !DemConfig                colin@nyphot.demon.co.uk
  874. ¤  !Qedit                    david@runge1.demon.co.uk
  875. ¤  !SparkPlug & SerialBuff   david@pilling.demon.co.uk
  876. ¤  SerialUtil & SerialDev    david@arcade.demon.co.uk
  877. ¤  !UUcoder                  john@bramber.demon.co.uk
  878. ¤  Guide1_21                 pla@sktb.demon.co.uk
  879. ¤  AcornFAQ                  afaiq@banana.demon.co.uk
  880. ¤  Demon Internet            internet@demon.net
  881. ¤  Zynet                     merlyn@zynet.co.uk 
  882. ¤  Guide (This doc)          alan@midwife.demon.co.uk
  883.  
  884. I hope I have adequately acknowledged the contributions of all the main 
  885. authors. I have tried hard to ensure that all the authors' own copyrights
  886. and conditions of use are maintained. If I have made any errors, then I 
  887. apologise in advance and undertake to correct them as soon as possible.
  888.  
  889. Thanks also to everybody who has sent me modem driver files - please
  890. keep them coming!
  891.  
  892.                              Alan Hassey (alan@midwife.demon.co.uk)
  893.                              =====================================
  894.  
  895. ---------------------------------------------------------------------end----